@uppy/informer

What is @uppy/informer?

@uppy/informer is a plugin for the Uppy file uploader that provides a way to display notifications and messages to users. It is used to inform users about the status of their file uploads, such as success, failure, or progress updates.

What are @uppy/informer's main functionalities?

Display Success Message

This feature allows you to display a success message when a file upload is successful. The message will be shown for 5 seconds.

const Uppy = require('@uppy/core');
const Informer = require('@uppy/informer');

const uppy = Uppy();
uppy.use(Informer, {
  target: 'body',
  timeout: 5000
});

uppy.on('upload-success', (file, response) => {
  uppy.info('Upload successful!', 'success', 5000);
});

Display Error Message

This feature allows you to display an error message when a file upload fails. The error message will be shown for 5 seconds.

const Uppy = require('@uppy/core');
const Informer = require('@uppy/informer');

const uppy = Uppy();
uppy.use(Informer, {
  target: 'body',
  timeout: 5000
});

uppy.on('upload-error', (file, error, response) => {
  uppy.info('Upload failed: ' + error.message, 'error', 5000);
});

Display Informational Message

This feature allows you to display an informational message when a file upload starts. The message will be shown for 5 seconds.

const Uppy = require('@uppy/core');
const Informer = require('@uppy/informer');

const uppy = Uppy();
uppy.use(Informer, {
  target: 'body',
  timeout: 5000
});

uppy.on('upload-started', (file) => {
  uppy.info('Upload started for ' + file.name, 'info', 5000);
});

Other packages similar to @uppy/informer

notyf

Notyf is a minimalistic, responsive, and customizable JavaScript notification library. It provides similar functionality to @uppy/informer by allowing you to display success, error, and informational messages. Notyf is more general-purpose and can be used outside of file upload contexts.

toastr

Toastr is a JavaScript library for non-blocking notifications. It provides a simple API to display success, error, warning, and info messages. Toastr is highly customizable and can be used in a variety of applications, not just for file uploads.

sweetalert2

SweetAlert2 is a beautiful, responsive, customizable, and accessible replacement for JavaScript's popup boxes. It can be used to display alerts, including success, error, and informational messages. SweetAlert2 offers more advanced features like modals and user input forms, making it more versatile than @uppy/informer.

README

@uppy/informer

The Informer is a pop-up bar for showing notifications. When other plugins have some exciting news (or error) to share, they can show a notification here.

Uppy is being developed by the folks at Transloadit, a versatile file encoding service.

Example

import Uppy from '@uppy/core'
import Informer from '@uppy/informer'

const uppy = new Uppy()
uppy.use(Informer, {
  target: '#mount-point',
})

Installation

$ npm install @uppy/informer

Alternatively, you can also use this plugin in a pre-built bundle from Transloadit’s CDN: Smart CDN. In that case Uppy will attach itself to the global window.Uppy object. See the main Uppy documentation for instructions.

Documentation

Documentation for this plugin can be found on the Uppy website.

License

The MIT License.

Changelog

4.1.1

Released: 2024-08-15

| Package | Version | Package | Version | | ---------------------- | ------- | ---------------------- | ------- | | @uppy/aws-s3 | 4.0.3 | @uppy/provider-views | 4.0.1 | | @uppy/companion | 5.0.5 | @uppy/status-bar | 4.0.2 | | @uppy/companion-client | 4.0.1 | @uppy/transloadit | 4.0.2 | | @uppy/core | 4.1.1 | @uppy/tus | 4.0.1 | | @uppy/dashboard | 4.0.3 | @uppy/utils | 6.0.2 | | @uppy/drag-drop | 4.0.2 | @uppy/vue | 2.0.1 | | @uppy/file-input | 4.0.1 | uppy | 4.1.1 | | @uppy/image-editor | 3.0.1 | | |

• @uppy/transloadit: fix issue with allowMultipleUploadBatches (Mikael Finstad / #5400)
• meta: Bump elliptic from 6.5.5 to 6.5.7 (dependabot[bot] / #5410)
• meta: add back patch for p-queue (Antoine du Hamel / #5409)
• @uppy/transloadit: fix many lurking TypeError (Mikael Finstad / #5399)
• docs: improve corsOrigins documentation (Mikael Finstad / #5390)
• docs: add ViewEncapsulation to Angular example (Aaron Russell / #5395)
• @uppy/companion: fix code for custom providers (Mikael Finstad / #5398)
• docs: add note about throwing in cancelAll and destroy() (Mikael Finstad / #5408)
• meta: Bump docker/login-action from 3.2.0 to 3.3.0 (dependabot[bot] / #5372)
• meta: Bump docker/setup-qemu-action from 3.1.0 to 3.2.0 (dependabot[bot] / #5370)
• docs: make hosted Companion more clear (Merlijn Vos / #5394)
• meta: Bump docker/build-push-action from 6.4.1 to 6.6.1 (dependabot[bot] / #5403)
• meta: bump p-queue to latest, remove patch (Mikael Finstad / #5391)
• meta: enforce .ts extension for relative import types (Antoine du Hamel / #5393)
• @uppy/tus: Fix onShouldRetry type signature (Trent Nadeau / #5387)
• @uppy/dashboard,@uppy/drag-drop,@uppy/file-input: Transform the accept prop into a string everywhere (Evgenia Karunus / #5380)
• docs: fix getTemporarySecurityCredentials in aws-s3 (Merlijn Vos / #5363)